Interrupt 21h Function 7160h Minor Code 0h 

Retrieves the full path for the specified file or path.

mov ax, 7160h

mov cl, 0                  ; Get Full Path Name

mov ch, SubstExpand        ; see below

mov si, seg SourcePath     ; see below

mov ds, si

mov si, offset SourcePath

mov di, seg DestPath       ; see below

mov es, di

mov di, offset DestPath

int 21h

 

jc  error

 

Parameters

SubstExpand

Flag that indicates whether the returned path should contain a SUBST drive letter or the path associated with the SUBST drive. Zero is specified to indicate that the returned path should contain the path associated with the SUBST drive, and 80h is specified to indicate that the returned path should contain the SUBST drive letter.

SourcePath

Address of a null-terminated string that names the file or path to retrieve the full path for. Either the long filename or the standard 8.3 filename format is acceptable.

DestPath

Address of the buffer that receives the full path. The buffer should be large enough to contain the largest possible Windows 95 path (260 characters, including the drive letter, colon, leading backslash, and terminating null character).

 

Return Value

Clears the carry flag, modifies the AX register, and returns the full path in the given buffer if successful. Otherwise, the function sets the carry flag and sets the AX register to an error value.

Remarks

When just a filename is specified, this function merges the name of the current drive and directory with the specified filename to determine the full path. Relative paths containing the characters  .  and  ..  in SourcePath are fully expanded. The function does no validation, so the specified filename or path does not need to exist.